home *** CD-ROM | disk | FTP | other *** search
/ Image Compendium / Image Compendium.iso / utility / gifdesk / gifsize.doc < prev    next >
Text File  |  1991-09-15  |  11KB  |  274 lines
  1.  
  2.  
  3.                           G I F S I Z E 
  4.  
  5.                            Version 1.2
  6.                        September 15, 1991
  7.      
  8.           A Resizing Program for Your GIF(tm) Pictures
  9.          Copyright 1990,1991 Steve Enns and Dan Magosse,
  10.                       All rights reserved. 
  11.  
  12.      GIFSIZE is produced by:
  13.  
  14.            Steve Enns                     Dan Magosse 
  15.         2425 Haultain Ave.             1321 14th St. East 
  16.           Saskatoon, Sk.                 Saskatoon, Sk. 
  17.           Canada S7J 1R2                 Canada S7H 0A6 
  18.  
  19.      This document has been stolen from the original GIFWARP!
  20.      document - if you have GIFWARP!, all the "humor" in here    
  21.      is ginna' seem familiar...
  22.  
  23.      Our motto:
  24.      
  25.      "We endeavour to pursue faithfully the highest principles in
  26.      sophisticated program design and development - until we're
  27.      offered more money or more exciting jobs."
  28.  
  29.      Top Ten Phrases heard around this lab:
  30.  
  31.                "What does `File Allocation Table Bad' mean?"
  32.                "Where was that bottle?"
  33.                "Sure it's weird, but will it sell?"
  34.                "Are these deductions right?"
  35.                "Where's that Stones tape?"
  36.                "Yah, C is okay, but can you do it in FORTRAN?"
  37.                "Where was that bottle?"
  38.                "I thought YOU fed the sled dogs!"
  39.                "Error handling?  What's that?"
  40.                "Where was that bottle?"
  41.  
  42.      Okay, here's the boring stuff, but don't worry, it's better
  43.      than chewing tinfoil:
  44.  
  45. ACKNOWLEDGEMENTS
  46.  
  47.      Kudos, thanks, and good karma to John Bridges for the
  48.      enlightening information and code contained in his VGAKIT
  49.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  50.      their respective companies. 
  51.  
  52. DISCLAIMER
  53.  
  54.      The GIFSIZE program is provided without warranty of any
  55.      kind.  The user of the GIFSIZE assumes complete
  56.      responsibility for any and all incidental or consequential
  57.      damages which may occur during normal or abnormal use of the
  58.      GIFSIZE program.  Use the GIFSIZE program at your own risk.
  59.  
  60. LICENSE 
  61.  
  62.      The entire GIFSIZE package, including the GIFSIZE program,
  63.      documentation, and sample files are Copyright 1990, Steve   
  64.      Enns and Dan Magosse.  All rights reserved.  The
  65.      unregistered shareware version of the GIFSIZE may be freely
  66.      distributed to others by any means, as long the following
  67.      (three) conditions are met:
  68.  
  69.           1) GIFSIZE is distributed in a "package" containing    
  70.           the following three files:
  71.                               GIFSIZE.EXE
  72.                               GIFSIZE.DOC
  73.                               GS-READ.ME
  74.           
  75.           2) GIFSIZE is not distributed as part of any other     
  76.           product, except with specific written permission from
  77.           the authors.
  78.  
  79.           3) NO fee of any kind is charged for the GIFSIZE
  80.           package or for the service of providing the package,
  81.           except Computer Bulletin Board Systems, which may
  82.           distribute the GIFSIZE package even though they may
  83.           charge a membership or service fee.
  84.  
  85.      You can use the "shareware" version for as long as you want,
  86.      even until you're well into your nineties, but you are of
  87.      course encouraged to send us lots of money, too. (I'm
  88.      struggling to pay for my violin lessons, and Dan needs a new
  89.      fishing rod.)  On the other hand, a "registered" version of
  90.      GIFSIZE is available from the authors for $8.00 U.S.  The
  91.      registered version provides support for 512K and 1024K
  92.      SuperVGA cards from most manufacturers (see REQUIREMENTS
  93.      below).  The registered version is licensed to the purchaser
  94.      exclusively, and may not be distributed to others.  To      
  95.      order the SuperVGA version of GIFSIZE, send $8.00 U.S.      
  96.      to the "Steve Enns" guy mentioned above.  You will receive a
  97.      5.25" (sorry NO 3.5" disks!) disk with the latest SuperVGA  
  98.      version of GIFSIZE.  If you send $23.00 or more, you will   
  99.      also receive the licensed SuperVGA versions of:
  100.  
  101.           GIFWARP!  Warp, bend or stretch your GIF(tm) pictures
  102.                     for bizarre and interesting effects.
  103.  
  104.           GIFCLIP   Clip/Crop parts from your GIFs.  Add text or
  105.                     your own GIF(tm) logos to your pictures.
  106.      and,
  107.  
  108.           GIFEXE    Make your GIF(tm) into an executable program. 
  109.                     Just run the program to display the picture. 
  110.                     Great for demos or displays or title screens
  111.                     for your programs.  Supports SuperVGA.
  112.  
  113.      Look for GIFEXE, and the unlicensed shareware versions of
  114.      GIFCLIP and GIFWARP! on your favourite bulletin board
  115.      system.
  116.  
  117.  
  118. REQUIREMENTS
  119.  
  120.           GIFSIZE requires the following:
  121.  
  122.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing
  123.                -    About 280K of free RAM
  124.                -    DOS 3.0, 3.1, 3.2, 3.3, 4.0 (others untested)
  125.                -    A mouse that at least claims to be
  126.                          compatible with something
  127.                -    A VGA or SuperVGA card
  128.  
  129.           and optionally:
  130.  
  131.                -    SuperVGA - The registered SuperVGA version of
  132.                     GIFSIZE supports modes like 640x480, 800x600
  133.                     with 256 colours on 512K and 1024K SuperVGA
  134.                     cards from ATI, Ahead, Cirrus, Chips and
  135.                     Technologies, Everex, OAK, Paradise, Trident,
  136.                     Tseng, Video7, Compaq, NCR, Genoa and VESA. 
  137.                     See the LICENSE section above for ordering 
  138.                     information.
  139.  
  140. INSTALLATION
  141.  
  142.      Copy the GIFSIZE program (and this helpful document of
  143.      course!) to any directory that you want - perhaps with      
  144.      your favourite GIF(tm) viewer somewhere in the DOS          
  145.      path.
  146.  
  147. USAGE
  148.  
  149.      Syntax for GIFSIZE is as follows:
  150.  
  151.           GIFSIZE [?] infilename[.GIF] [outfilename[.GIF]]
  152.  
  153.      or
  154.  
  155.           GIFSIZE [?] infilename[.GIF] [outfilename[.GIF]]
  156.                     [/mode={0,1,2,3,4}]
  157.  
  158.      for the registered version.  ( The /mode=n parameters are as
  159.      follows:       /mode=0        Ordinary 320x200 mode
  160.                     /mode=1        Low resolution SVGA
  161.                                         640x400 or 640x350
  162.                                         depending on your card.
  163.                     /mode=2        Medium resolution 640x480
  164.                     /mode=3        High resolution 800x600 
  165.                     /mode=4        Higher resolution 1024x768
  166.                                    supported on some 1024K cards.
  167.                                                        
  168.      For example, try:
  169.  
  170.           C> GIFSIZE               to see the title screen
  171.  
  172.           C> GIFSIZE ?             to see the help/brag screen
  173.  
  174.           C> GIFSIZE house         to view/resize the file
  175.                                    HOUSE.GIF writing the resized
  176.                                    picture (if any) to the 
  177.                                    default name GIFSIZE.GIF
  178.  
  179.           C> GIFSIZE house house2  view/size the file HOUSE.GIF,
  180.                                    writing output to HOUSE2.GIF
  181.                
  182.      With the registered version:
  183.  
  184.           C> GIFSIZE car /mode=2   View/size CAR.GIF using medium
  185.                                    resolution SuperVGA
  186.                               
  187. TUTORIAL
  188.  
  189.      Try out the following with your favourite GIF(tm) picture:
  190.  
  191.                C> GIFSIZE picturename
  192.  
  193.      GIFSIZE will load the picture and display it one your
  194.      screen.  The mouse cursor will appear in the centre of the
  195.      picture along with the coordinates of the current position. 
  196.      Choose the area of the picture that you want to resize by
  197.      pressing and holding down the left mouse button while moving
  198.      the mouse.  This "clipping box" will move as you move the
  199.      mouse.  Release the left button when the "clipping box" is
  200.      the appropriate size.  Now choose another box in the same
  201.      way.  The second box may be bigger or larger than the first
  202.      box, and may be anywhere on the screen.  When you chosen two
  203.      boxes,  press the right mouse button.  The area of the
  204.      picture that you chose with the first box will be resized   
  205.      to fit into the second box.  Any number of these resizings
  206.      may be done.  When you are done, press the <ENTER> key, and
  207.      the last resized image will be saved.  If you want to exit
  208.      GIFSIZE without saving the resized picture, press the <ESC>
  209.      key. 
  210.  
  211.  
  212. ERRORS
  213.  
  214.      - The following self explanatory error messages may be
  215.      produced by GIFSIZE.  The errors involving the GIF(tm) files
  216.      will generally be due to disk errors or faulty image files. 
  217.      Other errors refer to lack of enough free RAM space, or lack
  218.      of required hardware (VGA and Mouse).
  219.  
  220.           Can't initialize VGA graphics!
  221.           Mouse driver not installed.
  222.           Can't allocate mouse memory!
  223.           Unexpected EOF reading GIF!
  224.           Premature end of GIF!
  225.           Not GIF file!
  226.           Invalid GIF format
  227.           Error writing GIF!
  228.           Buffer allocation failure!
  229.           Can't continue - you're not smiling!
  230.           
  231. NOTES
  232.  
  233.      - GIFSIZE reads both GIF87A standard (the original) and     
  234.      new GIF89A pictures, although most of the extensions in the
  235.      new GIF89A standard like (silly) text windows are ignored. 
  236.      The last image in multi-image GIFs will be the one displayed
  237.      for resizing in GIFSIZE.
  238.  
  239.      - Although only the registered copy of GIFSIZE provides     
  240.      full SuperVGA resolution, all GIF pictures can be decoded   
  241.      and displayed on all versions of GIFSIZE.  If the image is  
  242.      too large for the available resolution, the image will be   
  243.      centred on the screen.  You will see the middle 320x200     
  244.      pixels of the image when the entire image is larger than    
  245.      320x200, for example.  The registered version of GIFSIZE    
  246.      will display images at resolutions up to 1024x768 according
  247.      to the size of the picture, or the specified mode.
  248.  
  249. HISTORY
  250.  
  251.      - Version 1.0 Completed July.10 1991
  252.  
  253.      - Version 1.2 Completed Sep.15 1991
  254.           Support for some additional cards and 1024x768x256 on
  255.           some 1024K cards, due to Bridges' new VGAKIT35 package.
  256.  
  257. PROPOSED FUTURE ENHANCHMENTS
  258.  
  259.      - Support for other graphics hardware.  Hopefully, we will
  260.      be able to support new hardware and graphics modes as they
  261.      are introduced.
  262.  
  263.      - Faster GIF(tm) decoding and encoding
  264.  
  265.      - Allow resizing to areas larger than the screen
  266.  
  267.      - Resize according to command line arguments, for batch mode
  268.      resizing
  269.  
  270.      - You tell me!
  271.  
  272.  
  273.  
  274.